home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1996 #15 / Monster Media Number 15 (Monster Media)(July 1996).ISO / lan / yipee110.zip / README.TXT < prev    next >
Text File  |  1996-05-20  |  14KB  |  300 lines
  1. ---------------------------------------------------
  2. This is a plain text version of the readme.wri file
  3. ---------------------------------------------------
  4.  
  5.                              Getting Started
  6.                                   with
  7.                                  y-IP-ee
  8.                           PPP/SLIP Version 1.10
  9.  
  10. 1. Introduction
  11. ================
  12.  
  13. With just a single IP address (fixed or dynamic) and an analog dial-up
  14. PPP or SLIP connection you can give your entire LAN full Internet access.
  15. Your LAN can be as small as a PC connected to a Mac, Amiga, PC etc. via
  16. a null-modem cable/ethernet, or it can be as big as you like. However,
  17. please remember that your bandwidth is fixed by the speed of your modem`s
  18. connection, so do not expect to have ten machines operating at 28kbps
  19. simutaneously. This isn`t physically possible!
  20.  
  21. yIPee is not a high level multi-proxy server system which tend to eat up
  22. TCP/IP resources, yIPee is a low level `IP masquerading` solution. Also,
  23. since yIPee is not a proxy based system this means that there are no
  24. restrictions on the number of different TCP services which you can
  25. access.
  26.  
  27. This is a working demo version of yIPee, so you can try it out for yourself. The demo version restricts you to a limit of 15 minutes on-line per connection.
  28.  
  29. System requirments are that your gateway machine (i.e. the one that will
  30. be atattched to the Internet) must be an IBM PC or compatible running
  31. Win3.x, Windows`95 or NT, and Core Systems TCP/IP v2.1.
  32.  
  33. (If you do not yet have this TCP/IP stack then you can download it from
  34. various ftp sites around the Internet. e.g.)
  35. ftp://ftp.tku.edu.tw/pc/winsock/Socket/inetv21.zip
  36. ftp://ftp.uni-rostock.de/Winsock/Misc_Utils/Dialers/inetv21.zip
  37. ftp://ftp.csusm.edu/pub/winworld/winsock/inetv21.zip
  38.  
  39.  
  40.  
  41. 2. Installation
  42. ===============
  43.  
  44. Before installing yIPee make sure that you have installed Core Internet-
  45. Connect (TM) correctly on your gateway machine, and that the rest of your
  46. LAN is responding to this machine. Also set up a serial interface on your
  47. gateway machine and connect to your Internet Service Provider, to make
  48. sure that your `gateway` is working ok as a single host machine. Please
  49. use the Serial Interface called "serial_0" (you can see this beside the
  50. Next/Prev buttons in the Core configuration program) to set the preferences
  51. for your gateway machine`s connection to your Internet Service Provider.
  52.  
  53.  
  54. 2.1 Configuration of Fake IP Addresses and Nameservers.
  55. =======================================================
  56. Your non-gateway machines will all have "fake" IP addresses, and your
  57. gateway machine will also have a "fake" address. (It will also have a
  58. real one too!!) You can make these addresses whatever you like with one
  59. proviso: The netid byte must be the same for all interfaces across your
  60. LAN and the value of this byte must be the same as the netid byte allocated
  61. to you by your Internet Service Provider. e.g. If your ISP allocates you
  62. an IP of 193.80.142.34, then all interfaces across you LAN should have IP
  63. addresses with a  netid byte is 193. (Even for those people with dynamically
  64. allocated IP addresses the netid byte should remain constant.)
  65.  
  66. Machine A        Machine B        Machine C
  67. 193.0.0.1--null modem--193.0.0.2         (gateway)
  68.                        193.0.0.3--ethernet--193.0.0.4
  69.                                             193.80.142.34----Internet    
  70.  
  71.                (A 3 machine LAN maye something like this)
  72.  
  73.  
  74. You must now also change the nameserver configuration on your non-gateway
  75. machines. The nameserver address for these should be set to the fake fixed
  76. IP address of your gateway machine. e.g. Using the diagram above, the
  77. nameserver option on machines A and B should be set to the address 
  78. 193.0.0.4
  79.  
  80. NB The nameserver option on your gateway machine should not be changed and
  81.    should point to the Domain Name Server of your Internet Service Provider.
  82.  
  83. NB If the connection between machines B and C (gateway) was a null-modem
  84.    link, then you must use the same link-layer protocol as you are using
  85.    for the connection between your gateway and your ISP. i.e. do not mix
  86.    PPP and SLIP on the gateway machine. (However, if the connection between
  87.    A and B was a null-modem link, then you could use either SLIP or PPP as
  88.    the link-layer protocol)
  89.  
  90. Providing it is physically possible we would always recommend, for
  91. performance reasons, that you should use ethernet instead of null-modem
  92. for your local LAN. Also, for similar reasons, if you have the choice
  93. between SLIP and PPP for your dialup connection, we would recommend that
  94. you choose SLIP as the preferred link-layer protocol since there is
  95. less overhead involved with SLIP as opposed to PPP.
  96.  
  97.  
  98. 2.2 Where to put the files!
  99. ===========================
  100. Very simple...
  101.  
  102. PPP_YIP.DLL, SLIP_YIP.DLL & HOOK_YIP.DLL must all be copied to your
  103. ..\WINDOWS directory. i.e. if you are using SLIP, you must still copy
  104. ppp_yip.dll to your windows directory and vice versa.
  105.  
  106. CORE.INI which is part of the Core TCP/IP distribution, must also be
  107. moved to your ..\WINDOWS directory. Please make sure to move it and not
  108. copy it to your windows directory. ie do not leave a copy of it in the
  109. COREWSDS directory.
  110.  
  111. YIPEE.EXE, you can place this file wherever you want.
  112.  
  113.  
  114. 2.3 Checking the Configuration of your Gateway
  115. ==============================================
  116. Finally, you should run the program CHK_YIP.EXE This program will examine
  117. CORE.INI file and make any changes to it which are critical to the operation
  118. of YIPEE.
  119.  
  120.  
  121.     
  122. 3. Starting up yIPee
  123. ====================
  124.  
  125. yIPee should not be started until you have dialled up and logged on to your
  126. Internet Service Provider. yIPee can then be launched by double clicking
  127. on the YIPEE.EXE program. You can do this from within the File Manager,
  128. or you can add this program to the Core Internet-Connect window by selecting
  129. "New..." from the file menu in Program Manager.
  130.  
  131. This paragraph applies only to those who have dynamically allocated IP
  132. addresses. There is currently no way in winsock to determine dynamically
  133. allocated IP addresses. Therefore, if you are on a dynamic connection,
  134. you will have to pass your IP address to yIPee by typing it into an
  135. edit-text requester which will appear after you have launched yipee.exe.
  136. You can easily obtain the value of your dynamically allocated IP address
  137. from the Core Winsock Monitor window. Select the menu item "Interface
  138. Statistics" from the "Stats" menu. If you select this menu item too early,
  139. ie before the stack has fully configured itself then the address might
  140. still read as 0.0.0.0 The solution is of course just to wait a second or
  141. two and then select the menu item again, and you will see the change to
  142. 193.80.142.34 or whatever IP address has been allocated to you.
  143.  
  144. If you quit out of yIPee whilst still on-line, the gateway machine will
  145. still continue to function normally, but the remainder of your LAN will
  146. now in effect be off the Internet. And of course you should quit out of
  147. yIPee after you have disconnected from the Internet. (Warning: in the
  148. evaluation version, you cannot simply run yipee.exe again to obtain a
  149. further 15 minutes, Core TCP/IP must be quit out of, ie expunged from
  150. memory, then re-loaded to obtain a further 15 minute allocation.)
  151.  
  152.  
  153.  
  154. 4. yIPee in Action
  155. ==================
  156.  
  157. yIPee deals specifically with the TCP protocol. This means that you can
  158. access any TCP based services from all machines on your LAN. Please note
  159. that a peculiarity of FTP is that data connections can be initiated by 
  160. the server you have contacted. This poses potential problems for yIPee.
  161. The solution to this problem is that you must set your FTP client into 
  162. PASV mode. This ensures all socket connections are initiated by your 
  163. client. Check the documentation of your FTP client for setting PASV mode.
  164. The above is not a problem for your gateway machine, FTP will work for it
  165. whether in PASV mode or not.
  166.  
  167. yIPee does not respond to ICMP and UDP packets generated by your LAN, 
  168. packets of these types will be ignored. Fortunately, this is not a problem,
  169. since 99% of applications make use of the TCP protocol. Client applications
  170. that will not work with yIPee are Ping, NFS (using UDP), Traceroute. NFS 
  171. using TCP will work. Also, for the same reason as FTP above, no server
  172. daemons can be run on your LAN machines. Again, as above, these limitations 
  173. do not apply to your gateway machine. It will be able to respond to ICMP 
  174. and UDP packets, and you will be able to run server daemons on it without 
  175. any  problems.
  176.  
  177. The aforementioned ICMP and UDP limitations are of course in the context 
  178. of your LAN`s connectivity with the Internet. That is to say, ICMP, UDP 
  179. and server daemons will work on any of your LAN machines but only across 
  180. your `local cable`. And of course as has been stressed before none of 
  181. these limitations apply to the gateway machine itself.
  182.  
  183. There is of course the obligatory exception. UDP clients (such as nslookup, 
  184. askhost etc.) which acccess the DNS will work on all machines on your LAN.
  185.  
  186.  
  187.  
  188. 5. Miscellaneous
  189. ================
  190.  
  191. Providing you have WSOCK32.DLL, then 32-bit Windows client applications 
  192. will work fine with Core TCP/IP since this dll has a "thunking" layer 
  193. built into to it to communicate with WINSOCK.DLL. (see Updates and 
  194. Upgrades for details of a full 32-bit version of yIPee)
  195.  
  196. Bug reports are welcomed. If you encounter what you consider to be a 
  197. bug, please submit a detailed description of the problem to: 
  198. donc@rmplc.co.uk
  199.  
  200.  
  201.  
  202. 6. How to Order Full Version
  203. ============================
  204.  
  205. By Cash:         You can send cash to the value of ú26 UK sterling 
  206.                         or $39 US dollars to the address given below. 
  207.                         Please include your e-mail address.
  208. By Cheque:        You can send a cheque made out to the amount of 
  209.                         ú26 UK Sterling. This cheque must be drawable on 
  210.                         a UK bank and should be sent to the address given 
  211.                         below. Please make the cheque payable to D.Cameron 
  212.                         and remember to include your e-mail address.
  213. By Eurocheque:      You can send a eurocheque made out to the amount 
  214.                         of ú26 UK Sterling to the address given below. 
  215.                         Please make the cheque payable to D.Cameron and 
  216.                         remember to include your e-mail address.
  217. By NetCash(TM):            You can send a NetCash(TM) coupon to the value of 
  218.                         $39 US dollars to the e-mail address below. 
  219.                         Please send your coupon encrypted using our PGP 
  220.                         public key file given below. (If your cyber-wallet 
  221.                         contains no NetCash(TM), then you can view their 
  222.                         homepage at the following URL, 
  223.                         http://www.teleport.com/~netcash)    
  224. ___________________________________________________________________________    
  225. ______________________________ContactDetails________________________________
  226.  
  227. Snailmail: T-SOFT,
  228.            PO Box 7971,
  229.        Ayr KA6 6QD
  230.        United Kingdom
  231.  
  232. E-mail: donc@rmplc.co.uk
  233.  
  234. WWW: http://www.rmplc.co.uk/eduweb/sites/donc
  235. ______________________________________________________________________
  236.  
  237. -----BEGIN PGP PUBLIC KEY BLOCK-----
  238. Version: 2.6.2i
  239.  
  240. mQCNAzGYG7sAAAEEANcGV7RVmr21aeh27wPdvVDV8nmQrRWyinPqkpyfRRGC4YKi
  241. PY7mF+nAc4gKVa4oUEs0bZR0fe2UdJkrOP2wLpaMfPtZrO++/reNu7s10QjG3dG8
  242. 8IZUSX9t4l+C9i5km5PEGnam3Omz/ljM4cPsBSiRjAeCECDAWfrT2vmbxWD1AAUR
  243. tCFEb25hbGQgQ2FtZXJvbiA8ZG9uY0BybXBsYy5jby51az4=
  244. =ppab
  245. -----END PGP PUBLIC KEY BLOCK-----
  246. ______________________________________________________________
  247.  
  248.  
  249.  
  250. 7. Updates and Upgrades
  251. =======================
  252.  
  253. Once you have purchased a copy of the full working version of yIPee, 
  254. this will entitle you to obtain all future updates and upgrades free of 
  255. charge. There already is an update available for ethernet users.
  256. Future full versions will include:
  257.     a) a 32-bit PPP version
  258.     b) a 32-bit SLIP version
  259.     c) a version supporting ISDN
  260.  
  261.  
  262.  
  263. 8. Licence Agreement & Copyright
  264. ================================
  265.  
  266. PLEASE READ THE FOLLOWING LICENSE AGREEMENT CAREFULLY BEFORE INSTALLING
  267. AND/OR USING THE SOFTWARE. If you do not agree to this license, 
  268. discontinue use of the software.
  269.  
  270. 1. GRANT OF LICENSE: T-SOFT grants to you the right to use one copy of 
  271.    the enclosed yIPee software package ("The SOFTWARE") on a single 
  272.    terminal connected to a single computer (i.e. with a single CPU). 
  273.    You may not use the SOFTWARE on more than one computer or computer 
  274.    terminal at the same time.
  275. 2. COPYRIGHT: The SOFTWARE is owned by T-SOFT and is protected by United 
  276.    Kingdom copyright laws and international treaty provisions. Therefore, 
  277.    you must treat the SOFTWARE like any other copyrighted material except 
  278.    that you may either (a) make one copy of the SOFTWARE solely for backup 
  279.    or archival purpose, or (b) transfer the SOFTWARE to a single hard 
  280.    disk provided you keep the original solely for backup or archival 
  281.    purposes. You may not copy the written materials accompanying the 
  282.    software.
  283. 3. OTHER RESTRICTIONS: This License permits you to use the SOFTWARE for 
  284.    your internal use provided that (a) the SOFTWARE is not modified in 
  285.    any way and (b) you maintain the copyright notice on all copies of 
  286.    the SOFTWARE. You may not rent, lease or otherwise transfer the 
  287.    SOFTWARE. You may not reverse engineer, decompile, or disassemble the 
  288.    SOFTWARE.
  289.  
  290. T-SOFT DISCLAIMS ALL WARRANTIES, EITHER EXPRESS OR IMPLIED INCLUDING BUT 
  291. NOT LIMITED TO IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A 
  292. PARTICULAR PURPOSE AND NONINFRINGEMENT. NEITHER T-SOFT NOR ITS SUPPLIERS 
  293. SHALL BE LIABLE FOR ANY DAMAGES WHATSOEVER, INCLUDING DIRECT, INDIRECT, 
  294. CONSEQUENTIAL, INCIDENTAL, LOST PROFITS OR INFORMATION, BUSINESS
  295. INTERRUPTION, OR OTHER PECUNIARY LOSS, EVEN IF T-SOFT HAS BEEN ADVISED 
  296. OF THE POSSIBILITY OF SUCH DAMAGES.
  297.  
  298.  
  299.                           *** Now Go Enjoy ! ***
  300.